home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / comm / qfaxv108.zip / README.1ST < prev    next >
Text File  |  1997-03-10  |  22KB  |  417 lines
  1.         Before you use QuickStar FAX Pro V1.08 for the first time...
  2.  
  3.     If you are eager to jump into tesing out this shareware FAX program
  4. and do not want to spend too much time reading all the documentations,
  5. you can now press the PageDown key and go directly to near the end of
  6. this readme.1st file. There you will find a section "QUICK START UP GUIDE"
  7. and that tells you all you need to know to start using QFAX. But if you
  8. will read on from here you will see an introduction of QFAX's features,
  9. it's history and what you can use it for.
  10.  
  11.     QuickStar FAX Pro is a MS-DOS shareware program which allows you
  12. to send plain text faxes from the DOS command line of your PC computer,
  13. using a Class 1 or Class 2 fax/modem in your PC computer that's connected
  14. to a telephone line. QFAX can be used manually to send faxes. Or it can
  15. be called from a batch file or from your own program repeatedly to send
  16. out batch faxes to multiple fax receivers. QFAX is very small, takes very
  17. little memory to run and is very simple to use, which makes it very good
  18. to be called by other applications as a automatic fax engine. QFAX is
  19. very suitable to be used on 80x86 CPU based palmtop computers, too, due
  20. to it's small size and easiness of usage. There is a specific HP palmtop
  21. version available, though this DOS version will work on both regular PCs
  22. and palmtops as well.
  23.  
  24.     Newest version of QFAX can be found and downloaded by visiting the
  25. World Wide Web site: http://WWW.QFAX.COM. Or by visiting some popular
  26. shareware sites. Inquiries should be sent by E-Mail to QFAX@QFAX.COM.
  27.  
  28.     Two new features are added to QFAX Version 1.08:
  29.  
  30.         a.You can insert PCX graphics files in the fax by editing the
  31.           original text file and insert something like this:
  32.             ~<myfile.pcx>
  33.  
  34.         b.You can insert pre-defined strings in the fax by editing the
  35.           original text file and insert something like this:
  36.             ~<$STRNAME>
  37.           And you can define the string on QFAX command line like this: 
  38.             QFAX  -def  STRNAME  John_Smith
  39.           or, in the QFAX.CFG file you can define it like this:
  40.             Define  STRNAME  John_Smith
  41.           Then on the received fax the string "John Smith" will be shown.
  42.  
  43.     The first new feature means you can easily insert your signature or    
  44. the logo of your company in the fax if you have the right PCX files. The
  45. PCX graphics files must be monochrome (line-art) graphics files and it
  46. will be mapped to fax pages dot-to-dot.
  47.  
  48.     The second new feature makes it very easy to use QFAX as a tool to
  49. send personalized fax broadcastings.
  50.     
  51.     Four remarkable things of QFAX are:
  52.  
  53.         1.FAST SPEED
  54.            QFAX normally faxes 3 pages per minutes at 14400 bps speed
  55.            for multiple page fax sessions.
  56.  
  57.         2.SMALL AND POWERFUL
  58.            The executable program is less than 60 KB in size and takes
  59.            very little memory to run. But yet it is powerful and a number
  60.            of useful features have been added to this small tiny chuck of
  61.            codes. When most programmers are talking about several MBs of
  62.            minimum memory requirement to make a Windows fax program work
  63.            properly, I am one of a few who stick to coding efficiency and
  64.            believe people still appreciate programs small and cute and
  65.            simple to use.
  66.  
  67.         3.EASY TO USE
  68.            As easy as typing in a DOS command like this:
  69.              QFAX  myfile.txt  fax_number
  70.  
  71.         4.FLEXIBILITY
  72.            You can write your own application and call QFAX and use it as
  73.            an automatic fax engine. All you need is a simple spawnl()
  74.            function in your C/C++ application. A C program is included
  75.            as an example as well as a useful tool.
  76.  
  77.     QFAX is a DOS program. It can be used in a pure DOS environemt or be
  78. used in a DOS session launched from the MS Windows. But if you run it in
  79. the DOS session launched from Windows, keep in mind that Windows simulate
  80. the Com Ports in the background. For any fax or communication programs to
  81. work properly in such situation you must configure the Com Ports in the
  82. Windows properly. In most cases it's aready properly configured in Windows.
  83. But if not you can open the "Main" program group and select "Control Panel".
  84. Then select "Ports" to configure the 4 Com ports.
  85.  
  86.     After you downloaded the QFAX Version 1.08 package from the network
  87. and unzipped it, please do a few things before you use it.
  88.  
  89.     1.First check the completeness of the package you get.
  90.       It should include the following files:
  91.  
  92.         file_id.diz     A small file describing QFAX (required by BBS's)
  93.         vendinfo.diz    A description file used by shareware distributors
  94.         readme.1st      The file you are reading now
  95.         qfax.cfg        The QFAX configuration file
  96.         qfax.exe        The main fax sending program
  97.         qfrec.exe       The fax receiver, decoder and converter program
  98.         qfaxconf.exe    Small program to help you to determine the modem
  99.                         port and create or modify qfax.cfg file
  100.         manyfax.c       A simple C program for personalized batch fax
  101.                         sending automatically, without user attendance.
  102.         manyfax.exe     The compiled program of manyfax.c
  103.         manyfax.lst     A file listing fax numbers (used by manyfax.exe)
  104.         usage.txt       The file explaining detailed usages of QFAX
  105.         register.txt    A text file telling you how to register QFAX
  106.         register.frm    Registration form to be used for registration
  107.         miscinfo.txt    Misc notes. About the Author. Where to find QFAX.
  108.         init.lst        List of proper InitStrings of various modems
  109.  
  110.     2. The QFAX.CFG may need to be edited and configured to meet the
  111.        specific configuration of your computer. You can either edit
  112.        QFAX.CFG file using the DOS edit, or you can use qfaxconf.exe
  113.        program to help create a customized QFAX.CFG file. You may simply
  114.        type "qfaxconf" at the DOS command line to start. But if you want
  115.        QFAXCONF.EXE to detect the modem port, use "qfaxconf -d" instead.
  116.        Please read the USAGE.TXT file for details.
  117.  
  118.     3. Read the REGISTER.TXT file for the license agreement and statement
  119.        of limited warranty. Simply using QFAX implies that you have read
  120.        and understand those conditions. And you agree to those conditions.
  121.  
  122.     4. Read the USAGE.TXT for information on how to use QFAX and on trouble
  123.        shoting tips. The usage is simple and straightforward but you may
  124.        still want to learn all the useful features of QFAX.
  125.  
  126.     If you have done all of the above and have configured the QFAX.CFG file
  127. according to the instructions given in the USAGE.TXT file, you can go ahead
  128. to test QFAX and use it regularly.
  129.  
  130.     If you find QFAX useful to you, please register it with the author. The
  131. REGISTER.TXT tells you the benefit you will obtain from registration and
  132. method of how to register. The registration is simple and cheap! QFAX is
  133. developed by a member of the Association of Shareware Professionals (ASP)
  134. and is distributed as a shareware program. For contact information of ASP,
  135. the official ASP OMBUDSMAN's statement and the concept of shareware please
  136. read the register.txt file.
  137.  
  138.     If you have any further questions regarding the usage of QFAX that you
  139. can not find the answer from the USAGE.TXT file, do not hesitate to ask the
  140. author. The REGISTER.TXT file has contact information on how to reach the
  141. author. Or you can simply E-Mail QFAX@QFAX.COM
  142.  
  143.     QFAX is a shareware program and may be redistributed freely. But there
  144. are some conditions: You must distribute QFAX in its original and complete
  145. and zipped format and you are not allowed to change content of any file.
  146. You are not allowed to distribute QFAX for purpose of profit. No charge
  147. can be made on the distribution of QFAX except for a reasonable charge for
  148. the handling and material cost of the distribution. Under above conditions
  149. please feel free to distribute the QFAX software package.
  150.  
  151.     Finally, if you ever forget how to use QFAX, simply type "qfax" and it
  152. will give you a quick reminder screen!
  153. ---------------------------------------------------------------------------
  154.  
  155. Update History of QuickStar Fax Pro:
  156.  
  157. Sep. 1, 1995    First Release of QFAX.             Filename: qfaxv10.zip
  158.  
  159. Sep. 2 - Sep. 30  Some modifications to make QFAX work more reliable. Add
  160.                   an option to let user decide whether to pause or not
  161.                   before the beginning of fax transmission.
  162.  
  163. Oct. 1, 1995    Release of V1.01.                  Filename: qfaxv101.zip
  164. Oct.2 - Dec.9   More tests and improvements made to QFAX. Some bugs fixed.
  165. Dec. 10, 1995   Release of V1.02                   Filename: qfaxv102.zip
  166. Feb. 25, 1996   Release of V1.03                   Filename: qfaxv103.zip
  167. Apr. 8, 1996    Release of V1.04                   Filename: qfaxv104.zip
  168. Apr. 20, 1996   Release of V1.04B                  Filename: qfax104b.zip
  169. Jun. 16, 1996   Release of V1.05                   Filename: qfaxv105.zip
  170. Jul. 15, 1996   Release of V1.06                   Filename: qfaxv106.zip
  171. Aug. 15, 1996   Release of V1.06 for HP            Filename: hpfax106.zip
  172. Sep. 15, 1996   Release of V1.07                   Filename: qfaxv107.zip
  173. Sep. 25, 1996   Release of V1.07b (fixed a bug)    Filename: qfax107b.zip
  174. Mar. 10, 1997   Release of V1.08 Dos Version       Filename: qfax108.zip
  175.                 Release of V1.08 for HP palmtop    Filename: hpfax108.zip
  176.                 Release of V1.08 Hebrew Version    Filename: qfaxh108.zip
  177.                 Release of V1.08 Chinese Version   Filename: qcfax108.zip
  178.  
  179.     Improvements of V1.03 comparing with V1.02 include the following:
  180.  
  181.       a.Greatly reduced the amount of memory used by QFAX, making it more
  182.         suitable to be called by other programs so the user can construct
  183.         their batch fax sending system.
  184.       b.A fax receive and/or decode program is added to the package.
  185.       c.Some improvement of the fax subroutines.
  186.  
  187.     Improvements of V1.04 from V1.03 include the following:
  188.  
  189.       a.A memory allocation bug fixed.
  190.       b.Self-check subroutine added to make sure that the program is an
  191.         authentic file. If it is infected by a computer virus or modified
  192.         by a computer hacker, it will give warning.
  193.       c.Added some more configurable parameters, including the Wait For Modem
  194.         Connection Time. The qfaxconf.exe program is improved to include the
  195.         new parameters in configuration of qfax.cfg file.
  196.       d.QFAX104B.ZIP is the same as QFAXV104.ZIP except it stores 8x16 font
  197.         directly in the program. QFAX104B.ZIP can be used on HP100LX/HP200LX
  198.         palmtop computers.
  199.  
  200.     Improvements of V1.05 from V1.04 include the following:
  201.  
  202.       a.The memory usage of qfax.exe has been reduced by more than 100 KB.
  203.         So the program is more suitable to be called from other applications.
  204.       b.A few improvements made the Post Page Message more reliable.
  205.       c.The self-check subroutine in V1.04 has been removed to reduce the
  206.         size of the program.
  207.  
  208.     Improvements of V1.06 from V1.05 include the following:
  209.  
  210.       a.Improved the fax part greatly so it works more reliably on some USR
  211.         modems and others. Total fax connection time is displayed at the end.
  212.       b.Improvement of the command line interface so it can now be used to
  213.         fax pre-processed fax files and support wild card file names. Now
  214.         multiple files can be faxed together in one fax session.
  215.       c.QFAXREC.EXE has more functions. It can now be used to receive a fax
  216.         call, or convert fax files of ANY format into a PCX file, or into a
  217.         fax file that can be used by QFAX.EXE.
  218.       d.QFAXREC.EXE now takes much less memory to run.
  219.  
  220.     Improvements of V1.07 from V1.06 include:
  221.       a.Some discovered bugs are fixed. The fax procedure is more reliable now.
  222.       b.New features added to QFAX.EXE. Now you can configure pause time
  223.         before re-dial if the phone line is busy. You can specify whether
  224.         to remove the created *.fax file or not in the qfax.cfg file.
  225.       c.Improved QFAXREC.EXE so it's more reliable, and now fax receive works
  226.         with Class 2 fax/modem, too.
  227.       d.Modified QFAXCONF.EXE to adopt added features in qfax.cfg file.
  228.  
  229.     Improvements of V1.08 from V1.07 include:
  230.       a.Use improved serial com subroutine and works more reliably.
  231.       b.Added the capabilities of insert PCX files, insert pre-defined
  232.         character strings, and word wrapping at end of each line.
  233.       c.Two parallel versions are added: the Hebrew language version and
  234.         the Chinese version.
  235.  
  236.     If the current version of QFAX you have is more than a few months old,
  237. the author may have already released a newer version of QFAX. Please check
  238. the author's web site: http://WWW.QFAX.COM. Or contactb the author by E-Mail
  239. at QFAX@QFAX.COM, QFAX@USA.NET or make phone call to 1-(814)-867-3385(H). 
  240. ===========================================================================
  241.  
  242.                 QUICK START UP GUIDE
  243.  
  244.     QFAX can be used to send plain text files as faxes, though one new
  245. feature in Version 1.08 allows you to insert PCX graphics files into
  246. the fax pages. QFAX can also send faxes received by QFAX or fax files
  247. converted from fax files used by other fax softwares, like WinFax's *.FXD
  248. and *.FXR files. QFAX Can NOT be used to fax MS WORD, WordPerfect or other
  249. word processor documents. Those documents are not plain text files. You
  250. have to save those documents to a different file as "plain text", "ascii"
  251. or "DOS text" format before you can use QFAX to fax them.
  252.  
  253.     A number of files are included in the QFAX distribution package. But
  254. only the following files are essential in sending and receiving fax:
  255.  
  256.         QFAX.CFG           The QFAX configuration file
  257.         QFAX.EXE           The fax sending program
  258.         QFREC.EXE          The fax receiving/converting program
  259.  
  260.     You have to put QFAX.CFG under the same directory as the executable
  261. programs, otherwise the program may not be able to find it.
  262.  
  263.     To start using QFAX, you need to do two things:
  264.  
  265.       a.Edit and configure the qfax.cfg file for your PC and fax/modem
  266.           ==> Configure the correct CommPort number    
  267.           ==> Use the correct InitString for your modem
  268.           ==> Put your own phone number in the PhoneNumber line
  269.  
  270.       b.To send a plain text fax, the easiest way is use a DOS command:
  271.  
  272.           qfax  text_file_name   fax_number
  273.  
  274.         for example:
  275.  
  276.           qfax  myfile.txt  1-800-555-1212
  277.  
  278.         There are other possible QFAX command line syntaxes. The formats
  279.         all look like this:
  280.  
  281.           qfax  [-option flags]  file1 [file2] [file3...]  fax_number
  282.  
  283.         You can have zero, one, or many option flags right after the
  284.         QFAX command and before the file names. All option flags will
  285.         start with a '-' sign and that's how QFAX will know it is an
  286.         option flag instead of a file name. Check the usage.txt file
  287.         for a detailed description of possible option flags.
  288.  
  289.         You can specify one or many file names followed by a fax number.
  290.         If you forgot the fax number QFAX will ask you for it after the
  291.         program starts. The fax_number string should starts with a number
  292.         and ends with a number, though commonly used symbols like - and +
  293.         and ()'s are allowed within the string (but try to avoid using
  294.         these extra symbols if the fax number itself is already too long)
  295.  
  296.     QFAX.CFG is a plain text file and you can use any plain text editor to
  297. change it, like using the DOS edit command. Or you can run the qfaxconf.exe
  298. program to configure and modify qfax.cfg file. To run qfaxconf.exe, just
  299. type "qfaxconf" from the DOS prompt. This program is pretty self-explained.
  300.  
  301.     The format of QFAX.CFG file is pretty straight forward once you see the
  302. example qfax.cfg file. The detail of the format is described in USAGE.TXT.
  303.  
  304.     The 3 MOST IMPORTANT things you need to configure in QFAX.CFG is the
  305. CommPort number, InitString and PhoneNumber. You do not need to change any
  306. thing else if you just want to use the default setting.
  307.  
  308. CommPort
  309.     The CommPort number is the COM Port that the modem occupies. QFAX need
  310.  number to access the modem correctly. Available numbers for CommPort are
  311.  from 1 to 8. The base addresses and IRQ numbers are listed as below. Check
  312.  your modem manual or consult a knowledgable person to find out what port
  313.  your modems is set to. If you are not sure, run the qfaxconf.exe program
  314.  like this:
  315.          qfaxconf  -d
  316.     This -d tells qfaxconf.exe to detect the modem port for you.
  317.  
  318.  CommPort COM/IRQ    Base_address  Description
  319.    1    COM1/IRQ4    3f8    --> commonly used by the mouse
  320.    2    COM2/IRQ3    2f8    --> most commonly used modem port
  321.    3    COM3/IRQ4    3e8
  322.    4    COM4/IRQ3    2e8    --> commonly used modem port
  323.    5    COM3/IRQ2    3e8    also called COM5
  324.    6    COM4/IRQ2    2e8    also called COM6
  325.    7    COM3/IRQ5    3e8    also called COM7 -> commonly used alternative port
  326.    8    COM4/IRQ5    2e8    also called COM8
  327.  
  328. InitString
  329.     The InitString is an AT command string that QFAX sends to the modem
  330.  to initialize the modem for faxing. QFAX will not be able to send fax
  331.  properly if the InitString is not set up properly, even if it may say
  332.  "Modem Initialize OK". Setting up the correct InitString is the most
  333.  tricky part of getting QFAX to work for you. Unfortunately different
  334.  modems may have different Initialize string and it is hard to figure
  335.  out what you should use if you have an unusual modem.
  336.     For QFAX to recognize the string correctly, do NOT leave any space
  337.  within the string. And all letters should be upper case letters, i.e.,
  338.  capital letters.
  339.  
  340.  Most fax/modems works using one of the following InitString:
  341.  
  342.         AT&F&C1&D2
  343.         AT&F
  344.         AT&F&C1&D2&K3
  345.         AT&F&A3&B1&H1&R2&I2&C1&D2  <--- Recommended for USR modems
  346.  
  347.     For initial test of QFAX you may want to attach "M2L3" to the end
  348.  of the InitString, like "AT&F&C1&D2M2L3". This AT command will keep
  349.  the speaker of the modem on during fax so you can hear the sound and
  350.  learn how the fax process goes on. Once you tested it and it works
  351.  fine you can remove "M2L3" to keep the modem quiet.
  352.  
  353.     Some popular fax/modems, like U.S.Robotics, use unusual InitStrings.
  354.  There are 6 solutions you can use for solving the InitString issue:
  355.  
  356.      1.Check the included file INIT.LST which lists recommended InitStrings
  357.  
  358.      2.Find out what other fax or communication program use for your modem
  359.        and copy the same string to see if it works.
  360.  
  361.      3.Check your modem manual to find a recommended AT initialize string.
  362.  
  363.      4.Visit the World Wide Web site "Ask Mr. Modem" to find out. They list
  364.        InitStrings of many brands of modems: http://molly.ipa.net/modem/
  365.  
  366.      5.Ask for the help from QFAX author by E-Mail: QFAX@QFAX.COM
  367.  
  368.      6.Try to construct an InitString yourself.
  369.  
  370.     For the last resort 6, consult the manual of your fax/modem and keep
  371.  in mind two things: The InitString should always start with "AT&F..".
  372.  This &F command will set almost every thing to factory default so it is
  373.  always used. Second, you must set it to use "Hardware Flow Control" or
  374.  some times it is called "RTS/CTS Flow Control".
  375.  
  376. PhoneNumber
  377.     The PhoneNumber is a string that Identifies your fax when your
  378.  fax/modem communicate with other fax machines. Normally it should be
  379.  your phone number. The length of this string should NOT exceed 20
  380.  characters. You can use your name instead. But please do not leave
  381.  this item blank.
  382.  
  383.     The rest of qfax.cfg is about font selection, page formatting etc. You
  384. can keep the default as it is for initial trials. For detailed information
  385. of those options please check the usage.txt file.
  386.  
  387.     You may put the name of the path that contains QFAX in the autoexec.bat
  388. file's PATH statement so next time you reboot the computer it will recognize
  389. QFAX from any directory. It is preferable that when you start QFAX, you go
  390. to the directory where your text file to be faxed is located. Even though
  391. usage like the following are allowed, too:
  392.  
  393.       QFAX  \mydir\myfile.txt 1-800-555-1212
  394.  
  395.     There are certain LIMITATIONS to the un-registered shareware version
  396. of QFAX. Those limitations includes:
  397.  
  398.       1.Nag screen at start to ask you for a license number (hint: enter 0)
  399.  
  400.       2.You will be unable to adjust page size, line spacing and character
  401.         spacing, after a certain trial period. though the faxing is still
  402.         fully functional.
  403.  
  404.     All those limitations will be lifted once you register the QFAX
  405. shareware with the author. If you want to use QFAX for the purpose of
  406. un-attended automatic batch fax sending, it is 100% sure you need to
  407. register to make it work, otherswise it will keep asking you for a
  408. license number, which means you will have to sit there to enter zero to
  409. get it going.
  410.  
  411.     To register QFAX, please read the file REGISTER.TXT for how to
  412. register. Or you may simply print out and fill out the REGISTER.FRM
  413. text file, and send it to me together with US$20 registration fee.
  414. ----------------------------------------------------------------------------
  415. For helps, contact me by E-Mail QFAX@QFAX.COM, or call 1-814-867-1468(H)
  416. ----------------------------------------------------------------------------
  417.